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RUMOPF is a document preparation program inspired fcv 
the program of the same name written by J, Saltzer at 
Project MAC This version has been Improved to provide more 
extensive control over the format of the resulting document, 
control over the output is exercised by the user in two 
wavst 



C 



(1) bv the use of special control characters inserted 
in text, see Section l.l, 

(2) By the use of command lines inserted in the text* 
These lines begin with dot, See Section 3, 



Text for input may be orepared using the qed text editor. 
Te use PUNQFF type "RUNOFF" to tne Time-Sharing Executive. 
runoff will respond with "LAYOUT FOR* » and the user should 
type T for TELETYPE, P for PRINTER, or for other, followed 
by a »i" or ",". (This command is used to determine the 
physical limits of the printing device,) Then the program 
types "INPUT FROM* ", at which point the user should type 
the input file name, terminated with either ".» or ",% 
PUNOFF then transforms the input file into an intermediate 
form, which is saved on the file /SBUNOFF TBXT$/, While 
runoff is processing in pass I, any erroneous lines will be 
designated by the message ■" ERROR IN LINE n», where n is 
the 010 line number of the line on which the errop was 
detected, in certain cases the actual error is in « 
proceeding line. 

If the input file name was terminated with »,", .the 
program will type "MOPE? " after processing the input file. 
The user should then type either V for YES or N for NO 
followed by ".". If the answer is YES, RUNOFF will ask for 
the name of another incut file. 

At the start of pass xi, the program will type, "OUTPUT 
TO: ", and the user should give a scratch file name, 
terminated with either %'* or *V'. If the file name is 
terminated with «•,"# RUNOFF will type "INTERACTIVE HYPHENA- 
TION? ", and the user should respond with either y for YES, 
or s for NO, followed bv a %», (See section 2.2 for a 
description of the interactive hyphenation process,) Errors 
detected in pass IX are marked with »*» in the output, 
PUNOFF will return to the Executive upon completion of the 
second pass. The user can then use the PRINT prcgpam to 
print the formatted file (see document R-36). 
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Text incut to RUNOFF consists of a symbolic file con- 
taining ] both the document' to be printed and the control 
information for formatting, a physical line is .a string of 
characters ending with carriage return and line feed. All 
physical lines which do not begin with "," are considered 
lines of the document to be cutout, initially, RUNOFF is 
set to "FILL" mode. All physical lines are collected into a 
single, logical, line up to the occurence of a line break. 
The logical line is then broken into as many physical output 
lines as are needed to fit within the line margins. These 
lines will then normally be adjusted fey inserting extra 
spaces in mid-line so that the end of the line is on the 
right margin. The end of a logical line, or line break, 
occurs when one of the following conditions is met* 



(1) There are one or more blank lines between two 
lines of text. (Extra blank lines in the text are 
ignored. in fill-mode. The user must use the 
appropriate command to ©reduce spaces.) 

(2) The next line begins a new paragraph. (RUNOFF 
recognizes paragraphs by seeing one or more 
blanks at the beginning of a line of text, 5 

(3) There is a logical line break. This is produced 
by the command BBEAK and certain other command 
lines, (See the summary for a full listing,) 



Any character in an actual text lint is interpreted as 
text except for the escape, shift, or tab character. The 
escape character is initially "t" but, may be changed by 
command (see section 2.8) i the initial shift character is 
»/", and tab is initialized to H \" (see section 2.8), The 
escape character and the immediately following one have 
special meanings as defined below t 



tA causes all subsequent uesper case characters in 
the text to be printed as lower case characters. 
This changes ASCII characters 40-137 to 100-177 
octal. 



tL converts upper case letters to lower case. ASCII 
characters 41-72 become 101-132 octal. This is 
the initial mode. 
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tu Upper ease-Do not convert to lower ease and ig- 
nore »ts» convention. 

tS Shift-Do not convert the next upper case eharac- 
ter as. above. The shift character "/» has the 
awe effect as "ts% 

tD converta the subsequent character to opposite 
case. For example, « to*" converta the ,, *« to «■+" 
in normal mode, 

tc capitalizes -the next word up to a seaca, carriage 
return, punctuation inarK, or tE, 

tB Backspace-overprint the proceeding character with 
the next character, 

fl underlines the next word up to a space, carriage 
return, punctuation iar&, or tE. 

t- Underlines ail characters up to a earriacre 
return, or fl, 

tl is used to force the end of underlining and capi- 
talization before the normal ssoundary occurs. 

tT denotes the end of « field for formatting .the 
tap character "V may also tee used. 

tY causes the current date to be output, 

ft Print an up arrow. 

t/ Print a slash 

tv Print a backslash. These control characters are 

modified in the obvious Banner if the escape, 

shift, or tafc characters are changed. 

Any uninterpretateie character combination will pse 
deleted and an error message will oe printed. 
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ft command Una begins with n , u , All letters ere con- 
verted to upper case In recognising the names of commands, 
macros* or formats, Following the dot RUNOFF expects a 
command name or an abbreviation, followed fcy the oararoeters 
for that command, followed octionally by a comment-. Lines 
beginning with dot but having an unrecognizable format are 
treated as errors, no lines beginning with dot are printed 
unless the proceeding line was .LITERAL. All commands are 
described below. Abbreviations for command names are 
normally based on the first two letters of a one word corn- 
mand or the first letter of the first two words of a 
multi-word command. Commands which should cause a logical 
line break do. Information on abbreviations and whether 
commands cause line breaks will be found in the summary at 
the end of the manual, in a command line runoff will 
consider multiple blanks as a single blank, if a blank 
character is legal. 
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.nofill 

.format <name> 

these commands determine which line-processing routine 
should be used, ".fill" causes RUNOFF to either 
lengthen short lines by filling with words from the 
following line or shorten long lines by breaking 
between words. Filling will not take cltce across a 
line break. In noflll-mode each input line produces 
one output line* further blank lines mx* output in this 
mode. «, format" causes subseouent text to be output 
under the control of the specified format (see below). 
Each following logical line will be fit info the format 
until a ".fill" or ".nofill" command is encountered. 

.adjust 

.nojust 

The adjust command causes all lines processed in 
fill-mode, except the last one before a line break, to 
be right justified. This is the initial state of 
RUNOFF. 
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.define format <name> <pos>; <fleld definition) •" 
and format 

These commands define a format for use in oroduelncr 
fables, etc* The <name> identifies the- formats the 
position <pcs> may be one of LEFT, RIGHT, or CENTER, 
and determines the overall position of the format with 
respect to the • margins. Each <field definition) has 
the formi 

<type>(<l«tt«r> ... <letter>) 

where the <type> is one of l for left, a for riaht, c 
for center* p for fill, or, J for justify. The first 
three tyoes define fixed fields f the text -to be format- 
ted must fit within the _ allotted space* The latter 
types define variable fieldst the text will be handled 
as In normal fill node orocessinf. 



A picture showing the manner in which text should be 
output follows the M .define .format" command) following 
the picture should be an .end format command. The 
following lines «ivs an example i 

.define format summary 1<A> HO c(B) 
aaaa cccccccccoecccccecceccccc ibbbbbb 
ccccccccccccccccccccccccc 

.end format /> p.. 

The first field of %*fkt is laft-juatifladt the- second 
is centered* the third is subjected .to fill-mode, pro- 
cessing without -justification. After the first line of 
output is generated usino, this format, ail subsequent 
lines are produced using the last picture line. 
(Strictly speaking the third line is unnecessary.) 



Text for formatted orccessino, consists of a logical 
line <or parafraeh}. fach field except the last must 
be separated bv a tab <«\ M or «tT"). The first field 
of text is *j the second, B etc. Tvpical input for our 
example might bej 

U\YES\/THIS IS SOME TEXT 
TO BE FILLED, 



The characters in the picture iine» are interpreted as 
follows, contiguous sequences of letters determine the 
field positions i non-alphabetic characters are output 
literally. (sotei "q.-aq" will fluQ* work? put the "■* 
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in the text.) A sequence of character® written between 
double quotes is considered literal text. The double 
ouotes axe not output* ana there is no way to use 

double quote as a literal. 



flflF ■£,„_ gy pn aB i-at 4 n p .u- b t q c^ t i - n.g 

when interactive hyphenation is specified, RUNOFF will 
tyoe "HYPHENATE! <word>» when it finds a word which shouia 
fee hyphenated! and which is not in the olcssarv. The user 
shouia then tyoe the word with hyphens* ana end the line 
with carriage return, control A ana control Q may be used 
to correct typing errors, if only carriage return is tyred, 
runoff will not try to hyphenate the word. interactive 
hyphenation say be turned off by ending: a. word with control 
33 instead of carriage return. 

At the end of -processing, RUNOFF writes the glossary on 
the file »/$GL0SSARY«/». if RUNOFF aborts during proces- 
sing, "CONTINUE RUNOFF." lay be used to dust the glossary. 



There are four conditions 
hyphenation takes places 



which must be met before 



(1) runoff fflust be in hyphenation mode. 

(2) The text at the end of the line must consist of a 
non-aiphanuffieric prefix, followed by an 
alphabetic string (which may also include »*"i 
"/«, and «'• characters), followed by a 
non-Alphanumeric suffix. The prefix and suffix 
may be empty . 

(3) There .must fee at least two characters before the 
hyphenation point and at least three characters 
after it. 

(4) The number of spaces to be inserted per word on 
the line roust be greater than the .hyphenation 
break parasieter (see below). 



If the word meets these conditions, then it will be broken 
at a ■•" or B / M (if any), or- at the right-roost- hyphen which 
fits the line if it is in the glossary. 
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•hyphenate 
.nohyphen 

in hyphenation wode runoff will try to find a word in 

the glossary which is the sane (except for the ending® 
-B t wES, -ED, and ■*B) as the word at the end of the 
line of text, RUNOFF is initially in hyphen mode but a 
null glossary produces nearly the same effect as 
NOHYPHBM lode, 

•glossary w 

This command inserts words into the glossary for use in 
hyphenation. Each word should have the form 

« hyphen-ate" and be separated by spaces, (The double 
quotes should aot be present,) 

.hyphenation breafc n 

This .commend sets the parameter which determines the 
allowable number of spaces to be inserted in a line 
fcefore RUNOFF tries to hyphenate the last word. Each 
space counts ten points, If wore than H points per 
word would have to be inserted, then hyphenation will 
be attempted. The initial setting of this para-teter is 
5 (one-half space per word). 



2 . SwMtffg-iiinwflQBtfr-p-1 s 

There are two types of margins involved in RUNOPFi 



(1) The physical margins. These are determined py 
the nature of the printing device. The margins 
outline the area where it is ehysically cessible 
to print characters , and are usually set with the 
LAYOUT option (see Section 1,0), 

(2) The logical margins. These- can be set by the 
user as he wishes, (Limit* are imposed by the 
physical margins.) They are initialized for 
standard 8,5" by 11" printing. 



Commands concerning vertical and horizontal margins arei 



.page layout tn, bm# tol 

This sets the vertical logical margins and vertical 
tolerance, parameters are toe margin, bottom margin 
and tolerance, The tolerance is used to determine 
where to break between sages on page overflows. If 
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there is a Una break within TOL lines of the bottom, 
RyNOFF will break the cage there* otherwise it will 
fill the page comcletely, 

.line layout LM, rm, NC, cs 

This sets the logical left ana right margins, the 
number of columns, and th« number of spaces to insert 
between columns. These margins are used for the rage 
headings. To adjust the relative text oosition, use 
th« subsequent commands, 

•reduce margin LM, m 

.expand margin LB, RM 

.end reduction 

These commands enable the user to indent a certain 
portion of his. text using the first command, or 
••undent" his .text using the second command, in either 
case the oris; inal margins are restored by the third 
command. The use of several «, reduce margin" commends 
before the corresponding ".end reduction" commands 
suceasivaly indents the text more, and more. Thus 
these commands are like brackets (is recursive) . w is 
added to the left logical margin and rh is subtracted 
,-■•• from the right logical margin in the first command, 

V ) Just the opposite is done on the second command. 

Negative numbers are -permitted, These commands do not 
affect the position of cage headings. 

.layout PLH, PPM, PTM, PBM, LL, LO 

This command, defines the phvsical margins in the fol» 
lowing complex manner. (It should only be used for 

non-standard devices > normally this command should jftot 
be necessary.) The parameters are the physical left 
margin (in spaces), the physical right margin, the 
physical toe line, the ohysical bottom line, the line 
length, and line origin. The first.. four parameters 
define the physical limits of the printing device. ..The 
final two parameters define the length of the logical 
line and its origin with respect to the left edge of 
the paper. Printing starts at column LO + . LM, and ends 
at LG ♦ RM, where LM and RM are the laaLekl margins 
established by ".line layout", when using the "facing" 
feature (see ", paging mode"), the logical left margin 
is LL - RM en even paces, and the right margin is LL - 
LM, The parameters for the lavout command must satisfy t 

fflinCtO + LL - PLM, PRK - LO) > 

maxIPLM - LO, LO + LL - PPM), 
LL > 2S, and Pifi - PTM > 6. 

O This command sets LM to 15, m to LL - 10, tm to PTM, 
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and BM to ¥Sn -.6, (These margin settings produce the 
standard 1,5 inch left, and 1 inch -right, toe, and 
bottom nargint.) 

initially RUNOFF sets the margin* for teletype outout toi 

.layout 6, 89, 6, 66, 85, 
•line layout 15, 7S 

the printer layouts 1st 

.layout 5, 137, 6, 66, 85, 18 

.br.page layout 6, 60, 4 

The logical margins nust satisfy! 

minlLL, PM <■ LO, LQ + LL «■ PLM) ^ f?M > 

LK i max (0» FLM • LO, LO ♦ LL - PRJO , 
PBM X Bfl > TM i PTM, and BM • T« > TQL, 



2 1 , 4u i ffftfffiffrffir | i.....yf ?i r 'i n 3^ tt i no 



.paragraph spaaing N 

This specifies how aanv lines are to be Inserted beteen 
paragraphs, initial setting * i. 

.paragraph indentation n 

This specifies how many additional spaces to insert at 
the beginning of a paragraph, initial setting ■ S, 

.paragraph undentatlon n 

This command is the same as ", paragraph indentation 
«N«, That is, K fewer spaees are inserted at the 
beginning of .the paragraph. 



2^5~3cflcia l^Ll a c~ Justification and-xantrbi. 

These commands pertain to the next logical line. The 
end of the line should be designated with a breaK. 



.center 

center the next line. 
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.indent N 

indent the next line n spaces, if k is not provided, 5 
is assumed, 

•undent N 

Start the next line N ipaces to the left of the normal 
margin. This command is the same as «» indent -»«, 

• maretin 

justify the next line against the right hand margin. 
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.header XXXXXXX 

RUNOFF accepts a heading to go on the first line of 
each page. The heading striner if assumed to start at 
the first non-blank character after the control word 
and end at carriage return. 

.heeding wode <param> 

<nara»> determines the postlon of the needing on the 
line. <param> may he any of the following, 

CINfER 

The header will fee centered on the line, 

MARGIN 

The header will fee adjusted against the rioht 
margin. 

FACING 

on even numbered bases the header is adjusted 
against the right margin, on odd eases it is 
adjusted against the left margin, 

OPPOSED 

the header will be adjusted againat the oppo- 
site, margin from tfte page number. This is 
the initial mode. 

.paging node <parai> 

This command determines the piecing of the cage number. 
All -parameters are optional. <paraw> may be any one or 
more of the following commands, in caae of conflict 
the latest command wins, 
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CENTER 

The page mincers are centered between the 
logical margins. 

MARGIN 

The paflc number is adjusted against the risht 
atargin, 

FACINO 

On even numbered sages the number win toe 
adjusted against the right margin. On odd 
numbered pages the number will toe adjusted 
against the left margin. 



TOP 



Page numbers are elaced on the first line, 



BOTTOM 

Page .numbers are elaced en the last line. 

OFF 

Printing page numbers is discontinued. 



PREFIX «<atrim> n 
( .) SECTION «<string>« 



SUFFIX »<string>" 

The strings of characters between quotation 

larks are used to form, the page string, which 
has the fieria* 

<cre£ix><seation><p80« number ><suffix>. 

Any or ail of these strings roav be null. The 
section string is oonsidered to be part of 
the rage number for purposes of indexing. 



initial icde iai 

•paging mode TOP margin prefix "Page" 

.paging mode SECTION ""SUFFIX "« 

If neither page nuaber nor heading is used, the text 
will start on the first logical line, otherwise it 
will start on the fourth logical line, if the rage 
number is at the bottom, text will end on the fourth 
line _ front the bottom, if the paging and heading node 
/" •, conflict, the page string overwrites the heading. 
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.odd page 

This control word causes the current page to be printed 
out end the next page to be started with tne next 
higher odd nuiber, 

.page » 

If N is present, insert a pace break and start number* 
ing the next page with n. Otherwise, turn the oaging 
ttode on and do not insert a page break, 

.eject N 

insert a page break If either there are fewer than n 
lines left on the page or n is not present. 



2*3 -Lice*., .and_££aci£a 

.single space 

Single space all lines within paragraphs. This is the 
initial state, 

/- " .double space 

V_.; Double space all lines within paragraphs, 

.space N 

Output N line spaces. If N is not orovidad, 1 is 
assumed, in case of page overflow all remaining blank 
lines to be output are deleted, 

.figure spacing N 

This command is equivalent to ".eject M" followed by 
'*, space N", These commands provide the only means of 
creating blank lines. 

a iP3;ft$iK 

The lines ^before and after this co&ieand will not be -run 
together in fill »ode, h simoler way to get a line 
break is to insert one or ©ore blank lines in the text, 

.begin group 

,end group 

The output lines enclosed between these two eoaiands 
are forced to lie on a page. Thus this command acts in 
a wanner similar to ".eject $«, where n has the 'right' 
value. 
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•underline 

The following line As underlined, 

■literal 

The next line if taken as ©art of text whether or not 
it begins with dot, 

.escape <char> 

•shift <ch«r> 

•tab character <char> 

The given character becomes the escape, shift* or tab 
character. The parameter for the .shift and .tab char- 
acter commands lay be null, if no shift or tab charac- 
ter is desired, 

.define command <name> 

.end command 

•Call <name> 

These commands give the user the opeortunity to combine 

text and control lines to fori his own commands, All 

text end command lines between the first and second 

V J commends is stored away under NAM, when the third 

command is executed, the stored string is read and the 
commends within the string are executed. Recursion is 
not permitted, 

.index <phrase>, <ohraae> 

■RUsbpp saves the first phrase in the main index table 
and the second phrase {if any) in a sub-index tebie 
associated with the first phrase, 

The index is formatted and output after the last cafe 
of text, two built-in but redefinable formats, HiUDEX 
and sxNDEXf are used to format the Index as shown in 
the following example. 

Algorithms, 40, 78, «■ uses RISDSX 
analysis of, 37, «• uses sitiDEX 

The following lines give the initial definitions for 
the indexing formats, 

.define format sindex f(A) 
/"~'"\ .end format 
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.define formt sindex £{a) 

AAAAAAAAAAAAAAAAAAAAAAAAA 
AAAAAAAAAAAAAAAAAAAAAAA 

.end format 



in order to get an index output in two colunns* ".line 
layout 15 f 75, 2, 4" should toe the last line of the 
input. 
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In the summary 

parameters. 



the following conventions ire used for 



Symbol Meaning 

» a nuiber 

C a character 

8 a string 

W - a word (or name) 

P a general parameter 
Any syiteol may be followed by *, indicating that its use is 
optional as that parameter of the command, if an optional 
parameter is left out, the effect is .to not change the state 
of., RUNOFF, except where stated otherwise above. The uae of 
+ following a break type indicate* that the actual break is 
dependent on the value or presence of the parameter. 



C 



f 









Tyre of automatic 


?br«viation com»and 




Break 


Section 


• fi 


•till 




line 


2.1 


• nf 


.noflll 




line 


2 


.1 


• ad 


♦adjust 




line 


2, 


,1 


• n1 


•nojust 




line 


2, 


.1 


• d£ 


.define format w P 




none 


2, 


A 


#6fi 


.end format 




none 


2, 


.1 


*£m 


•format w 




line 


2, 


.1 


• hy 


.hyphenate 




none 


2, 




• nh 


.nohyphen 




none 


2, 


a 


*9l 


.qlossary W ... w 




none 


2, 


,2 


• hb 


.hyphenation break 


# 


none 


2, 


,2 


♦ la 


.layout tu, «*, n* ( 


N** N*» 


N* cage 


2, 


.3 


• Pi 


• cage layout n*> N* 


', N* 


cage 


2, 


.3 


.XI 


.line layout N*» n< 


', v*f n* 


column 


a, 


» 3 


*ra 


•reduce margin N*, 


M* 


line 


2, 


.3 


• ti 


.expand margin N*, 


U* 


line 


2, 


.3 


• er 


•end reduction 




line 


2. 


.3 


• P? 


•earagraph spacing 


M 


none 


2. 


.4 


♦ pi 


.paragraph indentation h 


none 


2, 


,4 


• pu 


•paragraph undentation N 


none 


2. 


,4 


«ca 


•center 




lint 


2, 


,5 


♦ in 


•indent »• 




line 


2, 


,5 


• un 


•undent N* 




line 


2, 


5 


♦i&a 


.margin 




line 


2. 


5 


♦ ha 


.header S 




none 


2, 


6 


• hi 


.heading mode p 




none 


2, 


6 


• pa 


.caging mode p 




none 


2, 


,6 


#co 


.odd caoe 




eaqe 


2, 


6 


#-pa 


• sage N* 




page* 


2. 


6 


.e1 


.eject M* 




page+ 


2. 


6 
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Abbreviation 



Command 



#$a ■single apace 

• ds .double $pace 
.as iipact N* 

•£• • figure spacing I 

.cr .crenK 

• bq .-begin arouc 

• ccr .end crsroyp 
•ul » underline 

a && iSi fl is* *!** %* t^p A* wl ifp 

■ es # escape c 

• •h # shift c* 

•te » tab t . character c* 

.etc .define comaand V 

• ec ,an<5 consiand 
,ci »eall,W 

•ix • index 3§ s* 



c. of Automatic. 


Biresx 


Section 


lint 


2.7 


line 


2*7 


lint 


2*7 


line 


2.7 


line 


2.7 


none 


2.7 


none 


2.7 


lint 


2.8 


none 


2.8 


none 


2.8 


nom 


2.8 


none 


2 • 8 


nana 


2.8 


none 


m . O 


none 


2.8 


none 


<£ . £$ 
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CONTINUE ENTRY, 6 

adluat, 4, is 

begin group, 12, 16 
bottom, 

paging mode, 11 
break, 12, ie 



call 


, 13, 


16 




center, 9 


r 18, 




heading 


mode, 


10 


paging i 


node, 


11 


control character, 


m i 


3 






h, 


2 






B, 


3 






c, 


3 






D# 


3 






E, 


3 






I, 


3 






L, 


2 






s, 


3 






T, 


3 






u# 


2 







Y, 3 

define coranand, 13, 16 
define format, 5, 15 
double space, 12, 16 

eject, 12, 15 
and aommand, 13, 16 
end format, 5, 15 
end group, 12, 16 

end reduction, 8, IS 
escape, 13, 16 
expand margin, 6, 15 

facing, 

heading mode, 10 
paging. mode, 11 

figure spacing, 12, 16 

fill, 4, IS 

format, 4, is 

glossary, 7, IS 



o 
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header* 10, is 
heading »©da, lo, 3,5 
hyphenate, 7, 15 

hyphenation terea'k, 7, 15 

indent* 10, 15 
index, 13, la 

layout* 9, is 
lint, 2 
line creak, 2 
line layout, S, IS 
literal, 13, 16 
logical line, 2 

margin, 10, is, 

heading mode, 10 
caging node, 11 

nofiil, 4, is 
nohyphen, 7, is 

noiust, 4, is 

odd case, 12# 15 
off, 

paging mode, .11 
opposed, 

heading node, 10 



pace, 12, is 

cage layout, 7, 15 

page string, 
definition of, 11 

paging mode, 10, is 

paragraph, 
definition, 2 
indentation, 9, is 
spacing, 9, IS 
undentation, 9, is 

physical line, 2 

reduce margin, 8, is 

shift, 13, 16 
single space, 12, i« 
space, 12, 16 

tab character, 13, IS 
too, 

paging mode* il 

undent, 10, is 
underline, 13, i« 



